home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / NEWREC.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  45 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _NewRec( lNewRec_DateStamp ) --> lAppendStatus
  8.  
  9. PARAMETERS:
  10.  
  11. lNewRec_DateStamp : TRUE = Date Stamp record if possible
  12.                     FALSE = No date stamp, even if possible (DEFAULT)
  13.  
  14. SHORT:
  15.  
  16. Append a new record to the current database, optionally with date/time stamp.
  17.  
  18. DESCRIPTION:
  19.  
  20. _NewRec() is a general purpose record appending function.
  21.  
  22. The only difference between this and a straight APPEND BLANK is that this
  23. function will date/time stamp the record *IF* it has fields called
  24. ADD_DATE,D,8,0 and ADD_TIME,C,8,0 *AND* lNewRec_DateStamp = TRUE.
  25.  
  26. This can be disabled by passing a logical FALSE as an argument to the
  27. function:
  28.  
  29. _NewRec(FALSE) appends a new record and does NOT date/time stamp it even if
  30. it DOES have the Add_Date/Add_Time fields.
  31.  
  32. Returns: TRUE if record is appended, else FALSE.
  33.  
  34.  
  35. NOTE:
  36.  
  37.  
  38.  
  39. EXAMPLE:
  40.  
  41. _NewRec()  // new record appended, no stamp even if fields present
  42. _NewRec(.T.) // new record appended, date stamp if fields present
  43.  
  44. ******************************************************************************/
  45.